home *** CD-ROM | disk | FTP | other *** search
/ Hand Picked Software / Hand Picked Software.iso / misc / dv / dv.doc < prev    next >
Text File  |  1995-03-13  |  65KB  |  1,705 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.                                  DOSview (tm)
  16.  
  17.                               "A DOS Extension"
  18.  
  19.  
  20.  
  21.  
  22.                       Written and (C)Copyright 1992-1993
  23.  
  24.                                       by
  25.  
  26.                                  Skip Bremer
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.                                  Version 1.3
  35.  
  36.                                    5/25/93
  37.  
  38.                               TABLE OF CONTENTS
  39.  ==============================================================================
  40.  
  41.      Topic                                                          Section
  42.      -----                                                          -------
  43.  
  44.      Introduction ......................................................  1
  45.  
  46.      Miscellaneous .....................................................  2
  47.           Requirements
  48.           Limits
  49.           Startup Options
  50.  
  51.      Files .............................................................  3
  52.           Required
  53.           Supporting
  54.  
  55.      Commands ..........................................................  4
  56.           General
  57.           Normal Function Keys
  58.           Alternate Function Keys
  59.           Shift Function Keys
  60.           Control Function Keys
  61.           Miscellaneous Keys
  62.  
  63.      DOSview Menu ......................................................  5
  64.  
  65.      Swapping ..........................................................  6
  66.  
  67.      Setup .............................................................  7
  68.           Switches
  69.           Colors
  70.           Viewers
  71.           Programs
  72.           Hot Commands
  73.           Save
  74.           Notes
  75.  
  76.      Editor ............................................................  8
  77.           Internal Editor
  78.           Internal Viewer
  79.  
  80.      Panel Mode ........................................................  9
  81.           Wide Mode
  82.           Snake Mode
  83.           Command Line
  84.  
  85.      DOS Mode .......................................................... 10
  86.           Normal Function Keys
  87.           Control Function Keys
  88.           Miscellaneous Keys
  89.           Command Line
  90.  
  91.      Tree Mode ......................................................... 11
  92.           Function Keys
  93.           Command Line
  94.           Notes
  95.  
  96.      User Menu Mode .................................................... 12
  97.           Function Keys
  98.           Notes
  99.  
  100.      Tagging ........................................................... 13
  101.  
  102.      Batch Mode ........................................................ 14
  103.  
  104.      Network Operation ................................................. 15
  105.  
  106.      Credits ........................................................... 16
  107.  
  108.      Shareware ......................................................... 17
  109.           Shareware
  110.           Distribution
  111.           Registration
  112.           Disclaimer
  113.  
  114.                                  INTRODUCTION (1)
  115.  ==============================================================================
  116.  
  117. DOSview (tm) was designed as a shell for MS-DOS (tm) that meets the real needs
  118. of computer professionals (and to some extent, casual users alike).  Whenever
  119. we faced a choice between enhancing the program's usefulness as a true
  120. programming tool as opposed to simply a DOS helper, the programming tool
  121. choice won out.  This is because we work in an environment that demands a
  122. quick, useful tool to help us do our job.  We support a large Netware 386 (tm)
  123. wide area network domain spanning Texas.  Our environment demands a tool that
  124. is always available with a useful and powerful command set to ease our job and
  125. thereby help us to support our users in a more professional manner.  Quite
  126. simply, DOSview, more than any other single product we know of, does just
  127. that.
  128.  
  129. We have found DOSview's tool set to be a very practical approach to DOS-level
  130. work.  Please use DOSview as you see fit, but if you continue to use it,
  131. please abide with the Shareware section of this documentation.
  132.  
  133. One of our overriding goals in writing DOSview was to keep it small and quick
  134. -- at all costs (with the exception of its menu system).  There are many
  135. things that we put into DOSview and then took back out again as we tried to
  136. balance size against functionality.  We are not unhappy with the overall
  137. result.  We hope it will satisfy you as well.  We wrote the code in Borland's
  138. Turbo Pascal (tm) 7.0 (real mode) with assembly code where needed.
  139.  
  140.                                 MISCELLANEOUS (2)
  141.  ==============================================================================
  142.  
  143. Requirements
  144. ------------
  145. DOSview's only known requirement is that it must run under DOS 3.1 or higher.
  146.  
  147.  
  148. Limits
  149. ------
  150. Maximum files in each panel: 2175
  151. Maximum directories in tree (Tree Mode): 4500
  152. Maximu directory levels to tree (Tree Mode): 12
  153. Maximum found files/directories in pick list: 3000
  154. Maximum capacity of internal editor: 65519 (63.99K)
  155. Maximum DOS history commands remembered: 24
  156.  
  157.  
  158. Startup Options
  159. ---------------
  160. DOSview is normally started by typing DV.  However, you may specify what drive
  161. each DOSview panel uses as its initial domain.  For example, starting DOSview
  162. with the command  DV C F will start DOSview and then attempt to point the
  163. current panel to drive C's current directory and the other panel to drive F's
  164. current directory.  Typing DV only would have pointed the current panel to the
  165. current drive (and directory) and the other panel to the root of the current
  166. drive.
  167.  
  168.                                     FILES (3)
  169.  ==============================================================================
  170.  
  171. Required
  172. --------
  173. The following files are necessary to run DOSview:
  174.  
  175. DV.EXE    The DOSview program.
  176.  
  177. DV.HLP    The help file.  This file must reside in DV.EXE's home directory.
  178.           That is, if DV.EXE is in C:\TOOLS, then DV.HLP must be there also.
  179.  
  180.  
  181. Supporting
  182. ----------
  183. The following files are made by DOSview:
  184.  
  185. DV.INI    The setup file.  This file is placed into DV.EXE's home directory
  186.           when you save the setup options screen.  See Network Operations for
  187.           different placement of this file.
  188.  
  189. DV.MNU    The user menu file.  This file is placed into DV.EXE's home
  190.           directory when you edit and save a menu specification.
  191.  
  192. DV.TRE    The tree file.  This file be placed in the root of the current drive
  193.           when you make a tree.
  194.  
  195.  
  196. Mini-Utilities
  197. --------------
  198.  
  199. DVV.EXE   DVView.  Optional-use external file viewer that can view very large
  200.           files of any type.
  201.  
  202. DVE.EXE   DVEdit.  Optional-use external file editor that supports a mouse and
  203.           multiple files/windows.  See its help screen for additional
  204.           features.
  205.  
  206. DVZ.EXE   DVZip.  Optional-use external compressed file viewer that can view
  207.           files within ZIPs, LZHs, ARJs and PAKs to the second compressed 
  208.           level.
  209.  
  210. DVF.EXE   DVFind.  Optional-use external text finder that can find text
  211.           recursively through subdirectories.
  212.  
  213. DVD.EXE   DVDoIt. Optional-use external batch utility that performs powerful
  214.           operations at the DOS level.  Can also be used interactively.  (with
  215.           registered version only)
  216.  
  217. DVM.EXE   DVMenu.  Optional-use external instant menu facility that can show
  218.           all executables or commands from a list - all in a pick list.  (with
  219.           registered version only)
  220.  
  221. DVC.EXE   DVCalc.  Optional-use programmer's 5-function calculator.  (with
  222.           registered version only)
  223.  
  224. DVA.EXE   DVAchart.  Optional-use external ascii chart in picklist format.
  225.           (With registered version only)
  226.  
  227. DVS.EXE   DVSecure.  Optional-use external computer security program.  (With
  228.           registered version only)
  229.  
  230. DVP.EXE   DVPost.  Optional-use external screen poster.  (With registered
  231.           version only)
  232.  
  233. DVQ.EXE   DVQuery.  Optional-use batch query utility.  (With registered
  234.           version only)
  235.  
  236. DVL.EXE   DVLog.  Optional-use computer logger utility.  (With registered
  237.           version only)
  238.  
  239.                                    COMMANDS (4)
  240.  ==============================================================================
  241.  
  242. General
  243. -------
  244. DOSview is primarily function key driven.  An alternate menu system is
  245. available.  But for quick work, we find the function key set most useful.  The
  246. function key line at the bottom of the panel windows is "live" - whatever
  247. state the keyboard is in, this line reflects it by showing the proper function
  248. key set.
  249.  
  250. For example, holding the Ctrl key down shows you the control function keys.
  251. This function key line is not present when only one panel is displayed.
  252. F1 will always show all of the function keys and shortcut keys on one compact
  253. screen.  Note that the function key commands on the function key line are also
  254. dimmed when their commands are not applicable.
  255.  
  256. Many of the most commonly used commands have a shortcut key which are normally
  257. control keys.  Some shortcut keys are keyboard keys, like '/' for Tree Mode,
  258. and only work when the DOS command line is empty.  All shortcut keys are
  259. listed as part of the discussion of their normal function key equivalents
  260. below and on DOSview's pull down menu.
  261.  
  262.  
  263. Normal Function Keys
  264. --------------------
  265. F1   HELP      DOSview contains context sensitive help.  Anytime you are about
  266.                to commit to a command, you may press F1 to learn more about
  267.                it.  Some commands take place immediately, and you will need to
  268.                consult this documentation for them.
  269.  
  270. F2   PANES     Toggles between panels, or a single panel, (Panel Mode) display
  271.                and a no panels (DOS Mode).  You have instant access to DOS in
  272.                either Panel Mode or DOS Mode, but DOS Mode is sometimes more
  273.                convenient.  See the Panel Mode and DOS Mode appendices for a
  274.                further explanation of these modes.  (Shortcut key = ^O)
  275.  
  276. F3   VIEW      Views the highlighted file.  See the Setup section for more on
  277.                viewing.
  278.  
  279. F4   EDIT      Edits the highlighted file.  See the Setup section for more on
  280.                editing.
  281.  
  282. F5   COPY      Copies the highlighted file or a group of tagged files.  The
  283.                default target is the other panel's domain, or if both panels
  284.                are the same, nothing.  It is important to note that all copy
  285.                and move sequences carried out by DOSview _always_ carry the
  286.                source file's attributes to the target copy of the file.  This
  287.                is what we call an "exact copy".  You always get exactly what
  288.                you had (not true with DOS).  When copying over readonly files,
  289.                you will be asked to confirm each copy.  When copying over
  290.                files that already exist, you will be asked to confirm.  In
  291.                this case you may answer O)verwrite to overwrite that one file
  292.                or A)ll to overwrite that one file and any others that may come
  293.                up (if copying multiple files).
  294.  
  295. F6   RENAME    Moves the highlighted file or a group of tagged files or
  296. -or- MOVE      renames one file or directory.  If moving, the default target
  297. -or- RENMOV    will be the other panel's domain, or if both panels are the
  298.                same, nothing.  If renaming, the default is the current name.
  299.                Move makes "exact" copies, as noted in the above discussion on
  300.                the COPY command.  When moving to files that already exist, you
  301.                will be asked to confirm.  In this case you may answer
  302.                O)verwrite to overwrite that one file or A)ll to overwrite that
  303.                one file and any others that may come up (if moving multiple
  304.                files).
  305.  
  306. F7   MKDIR     This command makes a directory that you name within the current
  307.                panel's domain.
  308.  
  309. F8   DELETE    Erases the highlighted file or a group of tagged files.  When
  310.                erasing groups of files, you will be asked to confirm the
  311.                erasures.  When erasing readonly files, you will be asked to
  312.                confirm each readonly file.  This command will also remove
  313.                empty directories.  You cannot erase readonly and hidden files
  314.                unless you are in Expert Mode (see Setup).
  315.  
  316.     {WIPE}     When you press F8 on a directory name that contains additional
  317.                files and/or directories below it, you will be asked twice if
  318.                you wish to remove the underlying structure.  If you answer
  319.                Yes, _all_ structure below the directory will be deleted, no
  320.                matter what the attributes of files within that structure are.
  321.                This is a quick and final "wipe" of the entire directory
  322.                structure.  Be careful!  The deletions are actually a
  323.                combination of file deletes and directory removes, nothing
  324.                cosmic.  But the effect is a thorough bulk cleaning of the
  325.                structure - all at once.  (Most unerase tools can bring back
  326.                the files deleted with this command).  This command only works
  327.                in Expert Mode.
  328.  
  329. F9   MENU      Brings up the DOSview menu system.  Once you learn the function
  330.                keys (and shortcut keys) you may find they are faster for
  331.                getting the job done.
  332.  
  333. F10  QUIT      Use this command to quit DOSview (from either Panel Mode or DOS
  334.                Mode).  You will be asked to confirm.
  335.  
  336.  
  337. Alternate Function Keys
  338. -----------------------
  339. F1   DRIVE <   Allows you to choose another drive for the left panel.  Only
  340.                on-line drives are shown.  You can simply type a drive letter
  341.                and a colon and press Enter at the command line for the current
  342.                panel, as well.  Press F2 to change the drive display window.
  343.  
  344. F2   DRIVE >   Just like DRIVE < except this command is for the right panel.
  345.  
  346. F3   VIEW2     An alternate way of viewing the highlighted file.  See the
  347.                Setup section for more on viewing.
  348.  
  349. F4   EDIT      An alternate way of editing the highlighted file.  See the
  350.                Setup section for more on editing.
  351.  
  352. F5   XCOPY     This command copies the entire highlighted directory and all of
  353.                the structure below it to the other panel's domain.  As with
  354.                all copy commands, all of the attributes are carried with all
  355.                of the files (but not non-dos like network attributes), so you
  356.                get an exact DOS-level file keeping all file attributes
  357.                intact.  You will be asked to confirm.  This is called pruning
  358.                and grafting by some other utilities and is only available in
  359.                Expert Mode.
  360.  
  361. F6   YMOVE     This command is just like the XCOPY command except that a move
  362.                is performed instead of a copy.  Again, it is called pruning
  363.                and grafting in some other utilities and is only available in
  364.                Expert Mode.
  365.  
  366. F7   FIND      Allows you to search for any file or file specification within
  367.                the current panel's domain.  The file specification should only
  368.                have trailing wild cards in the filename or the file extension,
  369.                like:  DV.*.  After finding the files, a pick list will be
  370.                displayed for you to choose from.  Choosing one of the found
  371.                files will take you directly to that file's location.
  372.                (Shortcut key = ^Z)
  373.  
  374. F8   HISTRY    Accesses the DOS command history window.  (Shortcut key = Æ=)
  375.  
  376. F9   LINES     Switches the display from normal 25 line mode to 43/50 line
  377.                EGA/VGA mode (if so equipped) and back.
  378.  
  379. F10  TREE      DOSview provides a complete hard disk tree facility for quickly
  380.                moving to a particular directory (great for networks).  See the
  381.                Tree Mode section for more.  (Shortcut key = /)
  382.  
  383.  
  384. Shift Function Keys
  385. -------------------
  386. F1   SORT <    Sorts the left panel's files by one of the following choices:
  387.  
  388.                FILENAME  EXT  SIZE  DATE&TIME  ATTRIBUTES
  389.  
  390.                The shortcut key ^S conveniently switches back and forth
  391.                between filename and extension sorts in the current panel.
  392.  
  393. F2   SORT >    Sorts the right panel's files by one of the following choices:
  394.  
  395.                FILENAME  EXT  SIZE  DATE&TIME  ATTRIBUTES
  396.  
  397. F3   VIEW1     Another way to view the highlighted file.  See the Setup
  398.                section for more on viewing.
  399.  
  400. F4   EDIT?     Allows editing of a new file or any file on the system.  See
  401.                the Setup section for more on editing.
  402.  
  403. F5   ATTRIB    Allows you to change one of the attributes for the highlighted
  404.                file or all tagged files in the current panel.  Note that for
  405.                directories you may toggle the hidden attribute only.
  406.                (Shortcut key = ^A)
  407.  
  408. F6   LABEL     Allows you to change the volume label for a disk in the
  409.                current panel's drive.  This does not work for network volume
  410.                names.
  411.  
  412. F7   FILTER    Allows you to filter what files are displayed in the current
  413.                panel.  You provide an extension and only those files will be
  414.                shown.  The extension can be less than three characters, but
  415.                _no_ wild cards may be used.  For example, TXT and SC are ok,
  416.                but SC?  is not.  (Shortcut key = ^F)
  417.  
  418. F8   TOTAL     Totals all of the files in the underlying structure of the
  419.                highlighted directory and then displays the total in the same
  420.                place individual file totals are shown.
  421.  
  422. F9   HEIGHT    Toggles the panel heights of both panels from short to tall and
  423.                back.  Combined with a 50-line screen and Snake Mode, you can
  424.                see a lot of files at once (135 total files versus 78 files in
  425.                short mode)!  (Shortcut key = ^Q)
  426.  
  427. F10  SETUP     This is how you set up DOSview's defaults and other items.  See
  428.                the large section on Setup for a full description.
  429.  
  430.  
  431. Control Function Keys
  432. ---------------------
  433. F1   PANEL <   Turns the left panel on or off.  (Also ^P or ShiftTab)
  434.  
  435. F2   PANEL >   Turns the right panel on or off.  (Also ^P or ShiftTab)
  436.  
  437. F3   VIEWER    Turns the other panel into a quick viewer.  Works great for text
  438.                files.  Press F3 or F4 (etc) to enhance this mode on any
  439.                particular file.  (Shortcut key = ^V)
  440.  
  441. F4   EDITL     Edits the last file edited with the last editor used (internal
  442.                or external), no matter where you are on your system.
  443.  
  444. F5   TOUCH     Changes the date or time for the highlighted file or all tagged
  445.                files.
  446.  
  447. F6   BATCH     Allows you to write on-the-fly batch files or text files based
  448.                on tagged files in the current panel.  See the Batch Mode
  449.                section for more on Batch Mode Operations.  (Shortcut key = ^B)
  450.  
  451. F7   STATS     Shows memory and disk statistics for the host machine.  The
  452.                total disk space will be inaccurate if you are spanning drives
  453.                on a network. (Shortcut = ^L)
  454.  
  455. F8   DATA      Controls what data is displayed for each file in the current
  456.                panel.  See Panel Mode and DOS mode appendices for more on this
  457.                subject.  (Shortcut key = ^D)
  458.  
  459.                The default is..
  460.  
  461.                FILENAME  EXT  SIZE (in Bytes)   DATE  TIME
  462.  
  463.                and the alternative is..
  464.  
  465.                FILENAME  EXT  SIZE (in KBytes)  DATE  ATTRIBUTES.
  466.  
  467. F9   WIDTH     Toggles the current panel between Wide Mode and Snake Mode.
  468.                See the Panel Mode section for more about these two modes.
  469.                (Shortcut key  =^W)
  470.  
  471. F10  USER      DOSview provides a built in menu for DOS commands that is
  472.                completely definable by you.  See the User Menu Mode section
  473.                for more.  (Shortcut key = =)
  474.  
  475.  
  476. Miscellaneous Keys
  477. ------------------
  478. ENTER          Runs the highlighted program or changes to the highlighted
  479.                directory.  If not on an EXE, COM or BAT file and not on a
  480.                directory, then this command views the current file.  See the
  481.                Setup section for more on viewing.  (Also ^M)
  482.  
  483. ^ENTER         Copies the current file or directory name to the DOS command
  484.                line.  (Also ^J)
  485.  
  486. TAB            Moves from the current panel to the other.  If the other panel
  487.                is not active (not visible), then TAB moves the other panel's
  488.                domain into the current panel, and vice versa (just like SWAP).
  489.                (Also ^I)
  490.  
  491. INS            Tags or untags the current file and moves to the next file.
  492.  
  493. +/-            Tags or untags groups of files.  The specification you give
  494.                acts exactly like the normal DOS * and ?  specifications.  When
  495.                there are a lot of files in the current directory, this process
  496.                can take a few seconds because it rereads the directory to get
  497.                an exact match.
  498.  
  499. `              Shows a pick list of all external viewers and editors and all
  500.                defined associated programs allowing you to run the highlighted
  501.                file name with any of them.
  502.  
  503. *              After tagging a set of files (through a COMP command for
  504.                example), this command allows you to immediately reverse all of
  505.                the attributes in the current panel.
  506.  
  507. ?              Performs a search for a directory name, like DATA.  Wildcards
  508.                and backslashes are not accepted.  This is very similar to the
  509.                file FIND command.
  510.  
  511. ^\             A quick way to get to the root directory.  Of course, you may
  512.                also type CD\ at DOSview's DOS prompt.
  513.  
  514. ^G             In Snake Mode, DOSview normally shows all files and directories
  515.                having a hidden attribute in a soft color "ghost" color.  You
  516.                can toggle this trait to show all files with a readonly
  517.                attribute instead.
  518.  
  519. ^R             Refreshes the current panel (not often needed).
  520.  
  521. ^C             Highlights files in both panels newer than the same file in the
  522.                other panel.  If a file does not exist in the other panel, it
  523.                will also be highlighted.
  524.  
  525. ^K             Finds duplicate files by name only in both panels.
  526.  
  527. ^U             Swaps the domain of both panels.  What was previously displayed
  528.                in the right panel is displayed in the left panel, and vice
  529.                versa.  The Snake/Wide Mode characteristics are not swapped,
  530.                however.  If only one panel is being displayed, then this
  531.                command will bring the other panel's domain into the current
  532.                panel, and vice versa.
  533.  
  534. AltA..Z,       Moves the highlight cursor to the next file starting with the
  535. Alt0..9, Alt-  character you pressed.  To continue the search, continue
  536.                pressing letters.  Any letters pressed after the first one do
  537.                not have to be Alt characters.
  538.  
  539.                                  DOSVIEW MENU (5)
  540.  =============================================================================
  541.  
  542. DOSview employs a menu system as an alternative interface provides an
  543. intuitive way for new users to learn the somewhat extensive function key
  544. interface.
  545.  
  546. Dimmed items on the menus are not available because of the current panel
  547. states (tagged or untagged files, highlighting a file or directory, etc.).
  548.  
  549. You may either use the Arrow Keys to move to an item and press Enter or simply
  550. press the highlighted character for the choice you wish to run.
  551.  
  552.                                    SWAPPING (6)
  553.  ==============================================================================
  554.  
  555. DOSview employs a swap algorithm in order to provide a reasonable amount of
  556. memory for DOS applications that are run from DOSview.  DOSview takes less 
  557. than 4K of memory away from applications to remember its shell
  558. characteristics.
  559.  
  560. DOSview gives an abundance of choices on where you would like to have it swap:
  561.  
  562. o    Extended memory controlled by HIMEM.SYS, QEMM.SYS, 386MAX.SYS, etc (XMS).
  563.  
  564. o    Expanded memory version 4.0 (EMS).
  565.  
  566. o    Hard disk (local or network {if you have write rights}).
  567.  
  568. o    RAMdrive defined in EMS memory (/E).
  569.  
  570. o    RAMdrive defined in XMS memory (/A).
  571.  
  572. You choose which way you want to go with the setup function.  See the Setup
  573. section for more.
  574.  
  575. If you allow DOSview to swap anywhere, it will try to swap in this order:
  576. EMS, XMS, and then the root of the drive you specified.  You have the
  577. flexibility in setup to disallow any of the two memory swapping options.
  578. Additionally, you may specify the drive that DOSview will use if it can't swap
  579. to memory.
  580.  
  581. We like to default DOSview to look for both EMS and XMS and then, if needed,
  582. swap to a privately mapped drive letter on the network (that we all have).
  583. Your needs may dictate that you negate one or both of the memory options
  584. depending upon what applications you are running.  We have found no
  585. inconsistencies in swapping to XMS with HIMEM.SYS loaded.  With this setup, we
  586. never end up swapping to disk.
  587.  
  588. DOSview has no problems running in a DOS window under Windows 3.1.  You can
  589. even run Windows _from_ DOSview if you feel the need.
  590.  
  591. When running on a network, you should keep the following in mind:  Do not try
  592. to run batch files that have mapping commands in them.  The maps will be for a
  593. child DOS process and the program you are trying to run will not be found.
  594. This is true of any shell program.
  595.  
  596. Of course, whether on a network or not, do not run memory resident software
  597. from DOSview.  This also is true of any shell program.
  598.  
  599. If DOSview cannot find a place to swap, then it will put a message under the
  600. DOS prompt before it runs the program to remind you of such.  You should
  601. correct the problem if this occurs because a lot of memory is being used in
  602. this case.  The message is:  (unable to swap).
  603.  
  604. CONFIG.SYS DOS command to provide XMS swapping memory:
  605.      DEVICE=HIMEM.SYS (or QEMM..  or 386MAX.., etc) {If you are not running
  606.        HIMEM.SYS - you probably should be...}
  607.  
  608. CONFIG.SYS DOS commands to provide EMS swapping memory:
  609.      DEVICE=HIMEM.SYS
  610.      DEVICE=EMM386.EXE 199 RAM
  611.  
  612. CONFIG.SYS DOS commands to provide a RAMdrive swapping drive:
  613.      DEVICE=HIMEM.SYS
  614.      DEVICE=RAMDRIVE.SYS 199 /E -or- /A
  615.      The /E is for XMS (extended) and the /A is for EMS (expanded).  You
  616.      should make sure your RAM drive has at least 200,192 actual bytes
  617.      available for the swap because RAMDRIVE.SYS will take a little overhead
  618.      when creating the drive.
  619.  
  620. Don't be confused!  Normally only DEVICE=HIMEM.SYS is needed to perform memory
  621. swapping.
  622.  
  623. Note that the shareware version of DOSview swaps a little more code than the
  624. registered version.  The above figures are for the registered version.
  625.  
  626.                                     SETUP (7)
  627.  ==============================================================================
  628.  
  629. The setup facility is accessed with the ShiftF10 key (or from the menu) and is
  630. what is used to configure DOSview to work the way you want it to work.  This
  631. discussion will talk about the setup items as they appear on the setup screen.
  632. The Tab and ShiftTab keys will quickly move around the different Setup Mode
  633. screens.  Then use the Down and Up arrow keys.  Ins toggles insert/overtype.
  634.  
  635.  
  636. SWITCHES
  637. ========
  638.  
  639. Color Scheme
  640. ------------
  641. You choose the color set you wish DOSview to use here.  This only affects the
  642. actual color schemes, not the video memory addresses (it figures that out all
  643. by itself).
  644.  
  645.  
  646. Screen Saver
  647. ------------
  648. If between 1 and 9, the screen will blank after that many minutes of keyboard
  649. inactivity.  0 disables this function.
  650.  
  651.  
  652. Allow EMS Swaps
  653. ---------------
  654. If Yes, then this is always the first place DOSview looks to swap to.  199K of
  655. EMS will be used for the swap.  See the Swapping section for more.
  656.  
  657.  
  658. Allow XMS Swaps
  659. ---------------
  660. If Yes, then this is always the second place DOSview looks to swap to.  It
  661. will swap to EMS first if available and you have that option turned on.  If
  662. swapping to XMS, then a little less then 199K will be allocated to DOSview for
  663. the swap.  See the Swapping section for more.
  664.  
  665.  
  666. Swap Drive
  667. ----------
  668. This is where you tell DOSview what drive to use for its swapping algorithm.
  669. You can only enter any drive letter that exists on your system except floppys.
  670. It will only swap to the root of this drive if the previous two memory
  671. swapping choices are both turned off or if DOSview cannot find any EMS or XMS
  672. memory to swap to.  On a network, we recommend that this drive be a privately
  673. mapped drive letter that is unique for each user.  See the Swapping section
  674. for more.
  675.  
  676. Novell H drive (for Home) example:  MAP ROOT H:=SYS:USERS\%LOGIN_NAME
  677.  
  678.  
  679. Show File Colors
  680. ----------------
  681. If Yes, then DOSview will show certain file extensions in color (see the
  682. Colors section below) and will show either hidden or readonly files in a
  683. "ghost" color.
  684.  
  685.  
  686. Show Volume Label
  687. -----------------
  688. If Yes, then DOSview will show the drive or volume's volume label just before
  689. the current directory at the top of each panel.
  690.  
  691.  
  692. Clock
  693. -----
  694. If yes, an on-screen clock (with military time) will be displayed.
  695.  
  696.  
  697. F4-Internal Editor
  698. ------------------
  699. This determines whether the internal or external editor is called when you
  700. press F4.  The other editor will run when you press AltF4.
  701.  
  702.  
  703. Expert Mode
  704. -----------
  705. If this switch is set to No, the following items will become non-functional:
  706.  
  707.      Editing and deleting readonly files
  708.      Showing hidden and system files (^G is also inoperative)
  709.      Wiping, Xcopying and Ymoving directories
  710.  
  711. Turn expert mode off when novice users will be accessing DOSview!
  712.  
  713.  
  714. Password
  715. --------
  716. If the screen saver is activated, and you define a personal password, then
  717. that password will be required before leaving the screen savers' screen.  The
  718. password must be between 1 and 8 characters long with no spaces.  Case is
  719. insignificant.  The password is stored in an encrypted fashion, so don't
  720. forget it!  The only way to remove the password is to reboot your machine and
  721. delete the DV.INI file before reentering DOSview.
  722.  
  723.  
  724. User Name for Net Prompt
  725. ------------------------
  726. The name to be shown in the DOSview prompt when on a network.  See the Network
  727. Operations section.
  728.  
  729.  
  730. COLORS
  731. ======
  732.  
  733. Ext
  734. ---
  735. This portion of setup is where you may define different display colors for
  736. certain file types.  For example, enter 'EXE' and 'E' to show executable files
  737. in bright white on a color system.  Trailing wild cards only are allowed here.
  738. Examples:
  739.  
  740. TXT
  741. TX
  742. TX*
  743. T*
  744.  
  745.  
  746. ?
  747. -
  748. In this slot you place a letter to represent the color you wish to use for the
  749. corresponding file type.
  750.  
  751.  
  752. VIEWERS
  753. =======
  754.  
  755. The following setup choices define how DOSview will interact with your files
  756. when viewing and editing them.  You may enter either the complete path name of
  757. the program or a shortcut defined as '&' before the program name is required.
  758. '&' means the program's path is the same as DV.EXE's home directory.  This is
  759. convenient when you wish to move DOSview around along with your defined
  760. support viewers.  The complete path (or '&') is used to ensure that DOSview
  761. runs the viewing program as quickly as possible (without DOS search support).
  762. The file extension must also be included in these cases.  If you elect not to
  763. include the path or the '&' shortcut, then the DOS path will be searched when
  764. attempting to run the program.  Example:
  765.  
  766.      c:\dos\dve.exe
  767.      &dve.exe (with DV.EXE being in the same directory as DVE.EXE)
  768.      dve
  769.  
  770. You may also use the ' ! ' phrase to force the highlighted filename to come
  771. before any defined switches on the viewer's command line.  Example:
  772.  
  773.      view ! /50  --instead of--  view /50   {this is normally not required}
  774.  
  775.  
  776. S
  777. -
  778. This determines whether DOSview will swap or not before running the program.
  779. Some external programs require swapping due to their memory requirements.
  780.  
  781. Swapping characteristics:  slightly slower loading, program's DOS screen
  782. visible after run, more memory available.
  783.  
  784. No swapping characteristics:  the opposite of the above.
  785.  
  786.  
  787. External Viewer1
  788. ----------------
  789. This program will normally call the highlighted file whenever you press F3,
  790. unless you have defined an external program for the highlighted file type.
  791. Even if defined, pressing ShiftF3 will force this program to run anyway.
  792. DVV.EXE is included as an option for you here.
  793.  
  794. External Viewer2
  795. ----------------
  796. This program will call the highlighted file whenever you press AltF3, no
  797. matter what else is defined.  DVV.EXE is included as an option for you here.
  798.  
  799.  
  800. External Editor
  801. ---------------
  802. Even though DOSview has a reasonable internal editor, you may wish to use your
  803. own.  You define that program here.  DVE.EXE is included as an option for you
  804. here.
  805.  
  806.  
  807. PROGRAMS
  808. ========
  809.  
  810. In addition to the viewing choices above, you may define specific associated
  811. programs for various file types here.  They will run when F3 (or Enter if
  812. defined for such) is pressed.  To bypass one of these viewers for External
  813. Viewer1, press ShiftF3 instead.  Both the '&' path rule and the ' ! ' filename 
  814. rule (as discussed in the previous section) also apply here.
  815.  
  816.  
  817. Ext
  818. ---
  819. Trailing wild cards only are allowed here.  Examples:
  820.  
  821. ZIP  &pkzip.exe -vbmn
  822. WK*  c:\lotus\123.exe
  823. W*   123
  824.  
  825.  
  826. S
  827. -
  828. This determines whether DOSview will swap or not before running the program.
  829. Some external programs require swapping due to their memory requirements.
  830.  
  831. Swapping characteristics:  slightly slower loading, program's DOS screen
  832. visible after run, more memory available.
  833.  
  834. No swapping characteristics:  the opposite of the above.
  835.  
  836.  
  837. F3
  838. --
  839. You may use either F3 or Enter to run the program.  If you define Enter, and
  840. one is not defined, then DOSview will look for an F3 definition.  If not
  841. found, then External Viewer1 will be used.
  842.  
  843. Do not define EXE, COM or BAT files with the Enter key.  DOSview already knows
  844. exactly what to do with them.
  845.  
  846.  
  847. Associated Program
  848. ------------------
  849. Enter the associated program's name here.  The full pathname (or using the '&'
  850. rule described above) will expedite program loading, though these choices are
  851. not required.
  852.  
  853. Here is something we use the associated programs section (F3 and Enter) for:
  854.  
  855. Ext S F3 Associated Program
  856. ZIP N Y  &dvz.exe - included external program that shows a pick list of zip 
  857.                     files for further viewing without actually unzipping the 
  858.                     zip file.
  859. LZH N Y  &dvz.exe 
  860. ARJ N Y  &dvz.exe 
  861. ZIP Y N  &pkzip.exe -vbmn -simply lists the zip file names to the screen.
  862.  
  863.  
  864. HOT COMMANDS
  865. ============
  866.  
  867. In addition to all of the above, you may also define up to ten "hot" commands
  868. for general use.  The hot commands are accessed by the CtrlShiftF1 through
  869. CtrlShiftF10 function keys.  Hot commands have nothing to do with the
  870. highlighted file or marked files.  They may have something to do with your
  871. panel's domain, however.  Hot commands only work in Panel Mode.
  872.  
  873.  
  874. Text
  875. ----
  876. The text to be displayed for the hot command on the function key line when
  877. holding down both Ctrl and Shift.
  878.  
  879.  
  880. S
  881. -
  882. This determines whether DOSview will swap or not before running the hot
  883. command.  Some external programs require swapping due to their memory
  884. requirements.
  885.  
  886.  
  887. Command
  888. -------
  889. Any command line that you can run from DOS (except memory-resident programs,
  890. of course) may be placed in a hot command.
  891.  
  892. There is three enhancements.  One, if you place a '+' at the beginning of the
  893. hot command, DOSview will treat it as a filename and try to edit it with its
  894. internal editor.  Two, you may use the '&' rule (defined above).  Three,
  895. placing a '?' after the hot command will let DOSview prompt you for command
  896. line parameters.
  897.  
  898.  
  899. SAVE
  900. ====
  901.  
  902. This saves the states of the two directory panels.  The saved panel items are:
  903.  
  904.      Active panel (Tab)
  905.      Other panel visibility (ShiftTab)
  906.      Panels height (ShiftF9)
  907.      Left panel Wide/Snake Mode (CtrlF9)
  908.      Right panel Wide/Snake Mode (CtrlF9)
  909.      Left panel sort key type (ShiftF1)
  910.      Right panel sort key type (ShiftF2)
  911.      Left panel data display (AltF8)
  912.      Right panel data display (AltF8)
  913.  
  914.  
  915. NOTES
  916. =====
  917.  
  918. The setup file, DV.INI, is normally kept in DV.EXE's home directory (see
  919. Network Operation section for an important exception).
  920.  
  921.                                     EDITOR (8)
  922.  ==============================================================================
  923.  
  924. INTERNAL EDITOR
  925. ===============
  926.  
  927. DOSview has an internal editor.  This means that any time you press F4, by
  928. default, DOSview will instantly edit the file with its editor.  Although the
  929. DOSview editor has some limitations, it also has some handy characteristics.
  930.  
  931.  
  932. Advantages
  933. ----------
  934. o    Instantly available and always there when you need it.
  935.  
  936. o    Line oriented blocking (many external editors, however, if they offer
  937.      blocking, will have more sophisticated blocking capabilities).
  938.  
  939. o    Instant cut and paste line operation (F3 and F4).
  940.  
  941. o    Built-in ascii chart.
  942.  
  943. o    Basic printing capability.
  944.  
  945. o    Word wrap, justification, case ops, shift ops, tab options, and white
  946.      space display options.
  947.  
  948. o    Secondary WordStar commands key set.
  949.  
  950. o    Automatic editing of readonly files, restoring that attribute upon
  951.      completion of editing.
  952.  
  953. o    Clean editing format, i.e., closes the file while it is being edited to
  954.      make life easier on a network.
  955.  
  956.  
  957. Disadvantages
  958. -------------
  959. o    Text file editing only.
  960.  
  961. o    Files of 65519 bytes or less.
  962.  
  963.  
  964. What's nice about the internal editor is that you can have it when you want it
  965. and still use your own favorite external editor when you wish.  See more about
  966. editing choices in the Setup section.  We think the DOSview internal editor is
  967. quite useful.  As meager as this documentation is -- it was done in its
  968. entirety with the DOSview editor.  (It helped us keep the doc small!)
  969.  
  970. Here are the internal editor commands by keys:
  971.  
  972.  
  973. Normal Function Keys
  974. --------------------
  975. F1   HELP      Context-sensitive help.
  976.  
  977. F2   SAVE      Saves the file being edited and continues editing.  (^KS)
  978.  
  979. F3   CUTB≈L    Cut either the current line or the current block (if a block is
  980.                highlighted) for later pasting.
  981.  
  982. F4   PUTB≈L    Pastes the last line or block that was cut (once).
  983.  
  984. F5   COPYB     Copies the marked block to the cursor position.  (^KC)
  985.  
  986. F6   MOVEB     Moves the marked block to the cursor position.  (^KV)
  987.  
  988. F7   BEGINB    Defines the beginning of a block.  (^KB)
  989.  
  990. F8   ENDB      Defines the end of a block.  (^KK)
  991.  
  992. F9   HIDEB     Toggles showing and hiding of a marked block.  (^KH)
  993.  
  994. F10  QUIT      Quits editing.
  995.  
  996.  
  997. Alternate, Shift and Control Function Keys
  998. ------------------------------------------
  999. F1   CHART     Displays an ascii chart.
  1000.  
  1001. F2   PRTB≈F    Prints the highlighted block or the entire file to LPT 1, 2 or
  1002.                3. (^KP)
  1003.  
  1004. F3   DELB≈L    Deletes the current block or line.  (^KY)
  1005.  
  1006. F4   CSEB≈L    Cases the current block or line to upper or lower case or
  1007.                toggles the case.  (AltU, I, O)
  1008.  
  1009. F5   WRITEB    Writes the current block to a file.  (^KW)
  1010.  
  1011. F6   READB     Reads a file into a block.  (^KR)
  1012.  
  1013. F7   JSTB≈L    Justifies the current block or line left, right or center with
  1014.                the current margins.  (AltL, C, R)
  1015.  
  1016. F8   SFTB≈L    Shifts the current block one character space to the left or
  1017.                right.  (Alt-, =)
  1018.  
  1019. F9   TABB≈L    Entabs (adds tabs) or detabs (deletes tabs) to or from the
  1020.                current block or line.  Entabbing makes tab characters out of
  1021.                every eight space string.  Detabbing makes eight spaces out of
  1022.                every tab.  (AltD, E)
  1023.  
  1024. F10  DISPLAY   Shows all file parts separate from non-file parts.  Great way
  1025.                to find extra spaces at the end of lines.  Also toggles between
  1026.                showing actual control characters and an easier-to-identify
  1027.                representation of them.  (^OD)
  1028.  
  1029.  
  1030. Miscellaneous Keys
  1031. ------------------
  1032. Ins            Toggles insert/overtype modes.  (^V)
  1033.  
  1034. Del            Deletes character at the cursor.  (^G)
  1035.  
  1036. ^T             Deletes word.
  1037.  
  1038. ^BkSp          Deletes word left.  (^H)
  1039.  
  1040. ^Y             Deletes current line.
  1041.  
  1042. ^QY            Deletes line right.  (AltK)
  1043.  
  1044. ^QL            Restores current line.  (^U)
  1045.  
  1046. ^OR            Sets right margin.
  1047.  
  1048. ^OI            Toggles auto indent mode.
  1049.  
  1050. ^OT            Toggles tab size between 8 and 5 characters.
  1051.  
  1052. ^OW            Toggles word wrap mode.
  1053.  
  1054. ^B             Reformats the current paragraph from the cursor position to the
  1055.                end of the paragraph.
  1056.  
  1057. ^OB            Reformats the entire document from the cursor position.
  1058.  
  1059. ^P             Enters a control character with the next character typed.  To
  1060.                enter an Escape character, press ^P and then Escape.
  1061.  
  1062. ^QF            Finds case insensitive.  (^Z)
  1063.  
  1064. ^QA            Finds and replaces.  The replace string case sensitive.  (^A)
  1065.  
  1066. ^L             Does the next find or replace.  (AltZ or ShiftTab)
  1067.  
  1068. ^QQ            Enter the current date and time. (AltQ)
  1069.  
  1070. ^K1..3         Define a text marker.
  1071.  
  1072. ^Q1..3         Go to a text marker.
  1073.  
  1074.  
  1075. Movement Keys
  1076. -------------
  1077. Arrows         One place in arrow direction.
  1078.  
  1079. Home           To beginning of line.
  1080.  
  1081. End            To end of line.
  1082.  
  1083. PgUp           Up one screen.
  1084.  
  1085. PgDn           Down one screen.
  1086.  
  1087. ^Home          To top of screen.
  1088.  
  1089. ^End           To bottom of screen.
  1090.  
  1091. ^PgUp          To top of file.
  1092.  
  1093. ^PgDn          To bottom of file.
  1094.  
  1095.  
  1096. Status Line Symbols
  1097. -------------------
  1098. The status line at the top of the editing screen is defined like this:
  1099.  
  1100. *FILENAME.EXT XX% Blk Ins Ind Tab:X Wrp:XX Row:XXXX Col:XXX Chr:XXX KB:XX  HH:MM
  1101.  
  1102. *              File has been modified and not yet saved.
  1103.  
  1104. FILENAME.EXT   The name of the file being edited.
  1105.  
  1106. XXX%            Cursor placement in the file as a percentage of 100%.
  1107.  
  1108. Blk            A block is marked and showing.
  1109.  
  1110. Ins            Insert mode selected (vs overtype mode).
  1111.  
  1112. Ind            Auto indent mode selected.
  1113.  
  1114. Tab:X          Tab size is X (5, 8).
  1115.  
  1116. Wrp:XX         Right margin is XX (28 - 78).
  1117.  
  1118. Row:XXXX       Row is XXXX (1 - 9999).
  1119.  
  1120. Col:XXX        Column is XXX (1 - 254).
  1121.  
  1122. Chr:XXX        Character at cursor is code XXX (0 - 255).
  1123.  
  1124. KBytes:XX    File is XX KBytes in size (0 - 64).
  1125.  
  1126. HH:MM          Current time.
  1127.  
  1128.  
  1129. Editor Notes
  1130. ------------
  1131. All switches and states (word wrap, last find string, etc) are remembered
  1132. between editing sessions as long as DOSview remains active.
  1133.  
  1134. The F3 and F4 keys (cut and paste) actually write, read and erase a temporary
  1135. block on disk.
  1136.  
  1137. Most commands move the cursor down one line after completion to make
  1138. repetitive editing operations easier.
  1139.  
  1140. The word wrap function offers an extra feature not found in a lot of editors
  1141. or word processors.  When wrapping a paragraph, it respects the correctness of
  1142. two following spaces after sentence endings.  In fact, it checks lines to make
  1143. sure this is the case, and if it finds an incorrect instance, it corrects it
  1144. during the wrap.
  1145.  
  1146.  
  1147. INTERNAL VIEWER
  1148. ===============
  1149.  
  1150. DOSview comes with its own internal viewer.  This means that any time you
  1151. press F3, by default, DOSview will instantly view the file with its viewer,
  1152. unless, of course, an 'ext' program has been defined.  The DOSview viewer is
  1153. quite weak and is only available in case a defined external viewer is not
  1154. available.  It is only meant for text files and is actually a read-only
  1155. implementation of the editor.  If you do not have an external viewer of your
  1156. own, we recommend you use the included DVV.EXE program here.
  1157.  
  1158.  
  1159. Advantages
  1160. ----------
  1161. o    The viewer is available in case you have nothing else to use.
  1162.  
  1163.  
  1164. Disadvantages
  1165. -------------
  1166. o    Text file viewing only.
  1167.  
  1168. o    Files larger than 64K will only display the first 64K.
  1169.  
  1170.  
  1171. See more about viewing choices in the Setup section.
  1172.  
  1173.  
  1174. Normal Function Keys
  1175. --------------------
  1176. F1   HELP      Context-sensitive help.
  1177.  
  1178. F10  QUIT      Quits editing the file.
  1179.  
  1180.  
  1181. Alternate, Shift and Control Function Keys
  1182. ------------------------------------------
  1183. F10  DISPLAY   Shows all file parts separate from non-file parts.  Great way
  1184.                to find extra spaces at the end of lines.  Also toggles between
  1185.                showing actual control characters and an easier-to-identify
  1186.                representation of them.  (^OD)
  1187.  
  1188.  
  1189. Miscellaneous Keys
  1190. ------------------
  1191. ^QF            Finds case insensitive.  (^Z)
  1192.  
  1193. ^L             Does the next find.  (AltZ or ShiftTab)
  1194.  
  1195.  
  1196. Movement Keys
  1197. -------------
  1198. Arrows         One place in arrow direction.
  1199.  
  1200. Home           To beginning of line.
  1201.  
  1202. End            To end of line.
  1203.  
  1204. PgUp           Up one screen.
  1205.  
  1206. PgDn           Down one screen.
  1207.  
  1208. ^Home          To top of screen.
  1209.  
  1210. ^End           To bottom of screen.
  1211.  
  1212. ^PgUp          To top of file.
  1213.  
  1214. ^PgDn          To bottom of file.
  1215.  
  1216.  
  1217. Status Line Symbols
  1218. -------------------
  1219. The status line at the top of the editing screen is defined like this:
  1220.  
  1221.  FILENAME.EXT                              Row:XXXX Col:XXX Chr:XXX  View  HH:MM
  1222.  
  1223. FILENAME.EXT   The name of the file being viewed.
  1224.  
  1225. Row:XXXX       Row is XXXX (1 - 9999).
  1226.  
  1227. Col:XXX        Column is XXX (1 - 254).
  1228.  
  1229. Chr:XXX        Character at cursor is code XXX (0 - 255).
  1230.  
  1231. View           Signifies read-only mode.
  1232.  
  1233. HH:MM          Current time.
  1234.  
  1235.                                   PANEL MODE (9)
  1236.  ==============================================================================
  1237.  
  1238. Panel Mode is the normal DOSview interface.  Normally two panels are visible,
  1239. left and right.  A panel shows a portion of the current drive for that panel.
  1240. It follows that the current panel shows the current drive (and directory)
  1241. while the other panel shows its drive and directory (which may not be the
  1242. current place unless both panels show the same thing).
  1243.  
  1244. Where a panel resides is called its domain.  In other words, if the current
  1245. panel (the panel that has the wide bar highlight cursor) is showing the TOOLS
  1246. directory contents on drive C, then that panel's domain is C:\TOOLS (the
  1247. current directory if you were really in DOS).  It's really very intuitive.
  1248.  
  1249. The top of each panel shows its domain name.  The current panel shows its
  1250. domain name in reverse colors, while the other panel shows its domain name in
  1251. the normal panel window frame color.
  1252.  
  1253. Within each panel are listed the directories (first) and the files (second)
  1254. that are in that domain.  They may be sorted in almost any fashion.  They may
  1255. or may not be filtered.
  1256.  
  1257. A big difference is whether the panel is in Wide Mode or Snake Mode.
  1258.  
  1259.  
  1260. Wide Mode
  1261. ---------
  1262. This is the alternate panel format.  In this mode, each line includes a file
  1263. or directory name and certain information about that file or directory.  The
  1264. wide bar cursor covers the width of the panel.  The top line in the panel
  1265. shows the titles for each field in the panel.  One of the field's titles is
  1266. always off-color, denoting the current sort key.  The bottom line in the panel
  1267. shows the totals for files, file sizes and directories within the panel's
  1268. domain.  Note that when files are tagged, the file and size totals change to
  1269. the totals for the tagged files only (the color changes to that of a tagged
  1270. file to help you remember this).  Also available on this line is a 'H' or 'R'
  1271. denoting whether all hidden or readonly files or shown in a "ghost" color via
  1272. the ^G GHOST command toggle.  Additionally, files may be colored differently
  1273. if the file colors switch is active (see the Setup section for more on this).
  1274.  
  1275. The size column may be in bytes or kilobytes, depending on the status of the
  1276. AltF8 DATA command toggle.  The same is true for the last column, which will
  1277. show either the file time or the file attributes.  (This is true to an extent
  1278. in both Wide and Snake Modes).
  1279.  
  1280.  
  1281. Snake Mode
  1282. ----------
  1283. This is the default panel format.  In this mode, each of three columns show a
  1284. continuing list of directory and file names from the previous column.  The
  1285. information for each file is now shown on the top line in the panel window.
  1286. One of the information items will still be off-color to denote the current
  1287. panel sort key.  The bottom line in the panel is the same as Wide Mode.
  1288.  
  1289.  
  1290. Command Line
  1291. ------------
  1292. These keys will manipulate the command line while in Panel Mode:
  1293.  
  1294. ^Left/^Right   Move left/right ONE character on the command line (Left/Right
  1295.                are used to move the wide bar cursor).
  1296.  
  1297. ^Home/^End     Move to the next WORD on the command line (Home/End are used
  1298.                to move the wide bar cursor).
  1299.  
  1300. ^E/^X          Use these keys to load the previous/next issued DOS
  1301.                command onto the command line (Up/Down are used to move the
  1302.                wide bar cursor).
  1303.  
  1304. ^BkSp/^T       Delete the previous/next word on the command line.
  1305.  
  1306.                                    DOS MODE (10)
  1307.  ==============================================================================
  1308.  
  1309. DOS Mode is the alternate DOSview interface.  When in Panel Mode, pressing F2
  1310. takes you to DOS Mode (removes the panels from view).  The purpose of DOS Mode
  1311. is really just to view the full DOS screen.  But while in this mode, the
  1312. command line is a little easier to use.  If you change directories and then
  1313. later change to Panel Mode with F2, the new current directory will become the
  1314. current panel's domain, as you would expect.  We use F2 a lot to see the DOS
  1315. screen and to sometimes enter complicated DOS commands and then press Up Arrow
  1316. to repeat or edit them.  That's why this toggle command is on such a choice
  1317. function key.
  1318.  
  1319. In DOS Mode these keystrokes are available:
  1320.  
  1321. Normal Function Keys
  1322. --------------------
  1323. F1   HELP      Mini-help.
  1324.  
  1325. F2   PANELS    Returns to Panel Mode.
  1326.  
  1327. F9   MENU      Brings up the DOSview menu.
  1328.  
  1329. F10  QUIT      Quits DOSview.
  1330.  
  1331.  
  1332. Alternate Function Keys
  1333. -----------------------
  1334. F10  TREE      DOSview provides a complete hard disk tree facility for quickly
  1335.                moving to a particular directory (great for networks).  See the
  1336.                Tree Mode section for more.  (Shortcut key = /)
  1337.  
  1338.  
  1339. Control Function Keys
  1340. ---------------------
  1341. F1   PANEL <   Turns on the left panel.
  1342.  
  1343. F2   PANEL >   Turns on the right panel.
  1344.  
  1345. F10  USER      DOSview provides a built in menu for DOS commands that is
  1346.                completely definable by you.  See the User Menu Mode section
  1347.                for more.  (Shortcut key = =)
  1348.  
  1349.  
  1350. Miscellaneous Keys
  1351. ------------------
  1352. ^L   STATUS    Shows the current machine status.
  1353.  
  1354.  
  1355. Command Line
  1356. ------------
  1357. Up/Down        Use these keys to load the previous/next issued DOS
  1358.                command onto the command line.
  1359.  
  1360. Left/Right     Moves left/right on the command line.
  1361.  
  1362. ^Left/^Right   Moves left or right one word on the command line.
  1363.  
  1364. Home/End       Moves to the beginning/end of the command line.
  1365.  
  1366. ^BkSp/^T       Deletes the previous/next word on the command line.
  1367.  
  1368. Ins            Toggle insert/overtype modes.
  1369.  
  1370. Esc            Restores and edited command line to its original form or
  1371.                deletes a command line.
  1372.  
  1373.                                   TREE MODE (11)
  1374.  ==============================================================================
  1375.  
  1376. DOSview has a Tree Mode that has one purpose, to find and go to directories
  1377. quickly.  Trying to navigate through many directories, even from within a
  1378. DOSview panel, can be tedious.  However, a quick '/' press works wonders.  All
  1379. of the intermediary directory reads needed to get to some deep directories are
  1380. passed when using the tree.  Once you try it, you'll see what we mean.  The
  1381. Tree Mode commands are:
  1382.  
  1383.  
  1384. Function Keys
  1385. -------------
  1386. F1   HELP      Tree Mode help.
  1387.  
  1388. F2   FIND      This command brings up a dialog box asking for the name of the
  1389.                directory you are searching for.
  1390.  
  1391. F3   NEXT      After moving to a directory on the tree's pick list, press F3
  1392.                to move to the next occurrence of the directory name you are
  1393.                trying to find.
  1394.  
  1395. F5   MAKE      This command remakes the tree in case you have changed your
  1396.                directory structure.
  1397.  
  1398. F10  CANCEL    This command quits Tree Mode.  Pressing Enter on a directory
  1399.                will do the same thing, of course, after taking you to that
  1400.                directory.
  1401.  
  1402.  
  1403. Notes
  1404. -----
  1405. After bringing up the tree, you can press the character keys to start an
  1406. incremental search.  For example, if you are looking for a directory named
  1407. TEMP, just start typing it:  T E M P.  DOSview will take you to that directory
  1408. name (if it is in the list) and then just press Enter to go to the directory
  1409. TEMP.  Alt keys are not used for this purpose here.
  1410.  
  1411. The tree file, DV.TRE, is always kept in the root directory of the current
  1412. drive in readonly, hidden status.
  1413.  
  1414. When attempting to make the tree file, DOSview always checks to see if it is
  1415. possible (you have rights to that root directory, etc.) before actually
  1416. starting the make.
  1417.  
  1418. If you select a subdirectory starting with the same name as a sibling
  1419. subdirectory under the same parent directory, DOSview may be unable to locate
  1420. it.  For example, in this tree segment:
  1421.  
  1422.   ├PARENT
  1423.   │├SUB
  1424.   │└SUB2
  1425.  
  1426. if you select SUB2, DOSview will probably report it as missing.
  1427.  
  1428. If you have too many directories, Tree Mode will command will not work.  But
  1429. in that case you may still use the '?' directory find command, which is quite
  1430. powerful in its own right.
  1431.  
  1432.                                USER MENU MODE (12)
  1433.  ==============================================================================
  1434.  
  1435. DOSview has a built-in menuing capability.  Probably the easiest way to
  1436. describe this is make a menu item and run it.
  1437.  
  1438. So..  press '=' to bring up the menu.  At first their will be nothing on the
  1439. list.  Press F2 to edit the list.  As an example, enter D on the first line.
  1440. Press the Space Bar once.  Enter Dir on the first line.  Tab once and enter
  1441. the '|' (pipe) symbol.  Enter DIR/W.  Press Enter to go to the next line.
  1442. Press F2 to save the menu file.  Press F10 to quit the editing mode (the menu
  1443. is simply a text file edited and held in the internal editor).  Press Enter
  1444. while pointing to your Dir menu command.  That's all there is to it.  You can
  1445. have a near unlimited number of items in this list.  Any typeable character
  1446. can be used as the menu character (case is sensitive here).
  1447.  
  1448. If you wish for DOSview to prompt you for input, place a '?' after the
  1449. command.  Then, when running that command, DOSview will ask you for optional
  1450. parameters.  You may type in the parameter or press ^Enter to insert either
  1451. the highlighted file or all of the tagged files (if less than 127 characters)
  1452. into the DOS command.  When editing the menu file, press F1 for a reasonable
  1453. display of how to enter a menu item (as we just did above).  Placing a '!'
  1454. after the command will cause DOSview to automatically use the highlighted file
  1455. as the parameter.
  1456.  
  1457.  
  1458. Function Keys (when using the menu)
  1459. -------------
  1460. F1   HELP      Help.
  1461.  
  1462. F2   EDIT      Edits the menu file.
  1463.  
  1464. F10  CANCEL    Quits User Menu Mode.
  1465.  
  1466.  
  1467. Function Keys (when editing the menu)
  1468. -------------
  1469. F1   HELP      Help (same as editor help).
  1470.  
  1471. F2   SAVE      Saves the menu file.
  1472.  
  1473. F3   CUTLN     Cuts the current line to a buffer.
  1474.  
  1475. F4   PUTLN     Puts the line from the buffer to the cursor position.
  1476.  
  1477. F10  QUIT      Quits editing.
  1478.  
  1479.  
  1480. Notes
  1481. -----
  1482. The menu file, DV.MNU, is always kept in DV.EXE's home directory in readonly,
  1483. hidden status (DOSview's internal editor can edit readonly files).
  1484.  
  1485. Note that when editing the menu file, you are actually in DOSview's internal
  1486. editor with a different window size.  All internal editor functions work
  1487. normally.  Also, F1 gives a good example of how to enter a new menu item.
  1488.  
  1489. Menu editing is only allowed when you are in Panel Mode.
  1490.  
  1491.                                    TAGGING (13)
  1492.  ==============================================================================
  1493.  
  1494. There is more than one way to tag a file or group of files in DOSview.  The
  1495. quickest and most used way is to use the Ins key to toggle the tag on the
  1496. currently highlighted file to on or off.
  1497.  
  1498. Note that when you tag files, the bottom line in the panel window changes to
  1499. the tagged color and now displays file and size totals for the tagged files
  1500. only.
  1501.  
  1502. Another way to tag files is to use the '+' key (either one) for tagging and
  1503. the '-' key for untagging.  In these cases, you will be asked for a file
  1504. specification.  Any true DOS wild card spec here (unlike some other areas of
  1505. DOSview) determines which files will be tagged or untagged.  When tagging a
  1506. large set of files, this process can take a few seconds or sometimes moments
  1507. (unless the spec is *.*) as DOSview rereads the panel and matches the
  1508. appropriate file names.
  1509.  
  1510. This +, - tagging is progressive.  In other words you may decide to tag *.EXE
  1511. files and then tag *.COM files.  The *.EXE set will remain tagged as the *.COM
  1512. files become tagged.  Untagging works the same way.
  1513.  
  1514.                                   BATCH MODE (14)
  1515.  ==============================================================================
  1516.  
  1517. The CtrlF6 BATCH command is available to help you perform batch operations on
  1518. defined groups of files in the current panel's domain.  After tagging the
  1519. files you wish to manipulate, press this command key and a dialog box will
  1520. appear.  Here are the dialog questions:
  1521.  
  1522. File name      Enter the name of the batch file you wish to make or run here.
  1523. ---------      The default is always ~DV.BAT.  If you do not change this name,
  1524.                then when you are ready to execute the information you have
  1525.                entered into the dialog box, DOSview will immediately run this
  1526.                batch file but will _not_ save it.  You will need to rename
  1527.                this default name to something else, like MY.BAT, in order to
  1528.                save it.  Then DOSview will immediately save the file but not
  1529.                run it.  You must then point to it and run it or enter its name
  1530.                on the command line.  This is so you can review and perhaps
  1531.                edit the batch file before executing it.  You can also name the
  1532.                file by an ordinary name like MYLIST as opposed to a batch file
  1533.                name (.BAT).  This can be extremely useful for those programs
  1534.                (like PKZIP (tm)) that can use a list file full of file names
  1535.                derivatives.
  1536.  
  1537. Text before    Enter any text you wish to place before each file listed (the
  1538. -----------    tagged files) in the batch/list file.
  1539.  
  1540. Format         Here, you have three choices on how DOSview will actually write
  1541. ------         the tagged file names to the file.
  1542.  
  1543.                P = the full pathname, like C:\TOOLS\MY.EXE;
  1544.                F = the filename and extension only, like MY.EXE; and
  1545.                N = the filename only, like MY.
  1546.  
  1547. Text after     Enter any text you wish to place after each file listed (tagged
  1548. ----------     files) in the batch/list file.
  1549.  
  1550. Note that the bottom line in the dialog box always shows you exactly the line
  1551. you are building with the above entries.
  1552.  
  1553. BATCH FILE example:
  1554. If you enter
  1555.  
  1556. MY.BAT
  1557. copy
  1558. N
  1559. B: /v
  1560.  
  1561. then DOSview would make this batch file:
  1562.  
  1563. copy FILEX.EXT   B: /v
  1564. copy FILEXX.EXT  B: /v
  1565. copy FILEXXX.EXT B: /v
  1566. etc..
  1567.  
  1568. where FILEX.EXT represents the files you have tagged prior to entering the
  1569. dialog box.
  1570.  
  1571.  
  1572. LIST FILE example:
  1573.  
  1574. If you enter
  1575. MYLIST
  1576.  
  1577. F
  1578.  
  1579.  
  1580. then DOSview would make this list file:
  1581. FILEX.EXT
  1582. FILEXX.EXT
  1583. FILEXXX.EXT
  1584. etc..
  1585.  
  1586. Here, you could then issue this command on the DOS command line:
  1587.  
  1588. PKZIP -U @MYLIST
  1589.  
  1590. instead of
  1591.  
  1592. PKZIP -U FILE1.EXT FILE2.EXT FILE3.EXT etc.
  1593.  
  1594.                               NETWORK OPERATIONS (15)
  1595.  ==============================================================================
  1596.  
  1597. Operating DOSview on a network is exactly like operating it on a standalone
  1598. machine with the following exception.
  1599.  
  1600. You _may_ configure DOSview so that each user gets their own DV.INI file.
  1601. Simply make a file that resides in DV.EXE's home directory called DV.NET.
  1602. Place the path for users' INI files on the first line of this file, like H:\.
  1603. All users must have access rights to this path and it must be a place that is
  1604. physically distinct for all users.  A "privately" mapped "home" drive is
  1605. perfect in this case, like mapping F:\USER\USERNAME to H:\.
  1606.  
  1607. In the above case, when a user starts DOSview for the first time, DOSview will
  1608. copy a DV.INI file from DV.EXE's home to the path defined in DV.NET.  It will
  1609. only do that if DV.INI is not already there.  From then on, the user has his
  1610. own INI file.
  1611.  
  1612.                                    CREDITS (16)
  1613.  ==============================================================================
  1614.  
  1615. Turbo Pascal is a trademark of Borland International.
  1616.  
  1617. PKZIP is a registered trademark of PKWARE, Inc.
  1618.  
  1619. MS-DOS is a trademark of Microsoft Corporation.
  1620.  
  1621. Netware and Novell are registered trademarks of Novell, Inc.
  1622.  
  1623. Windows is a registered tradmark of Microsoft Corporation.
  1624.  
  1625. Trademarks of other companies mentioned in this file are the property of their
  1626. respective companies.
  1627.  
  1628.                                   SHAREWARE (17)
  1629.  ==============================================================================
  1630.  
  1631. Shareware
  1632. ---------
  1633. THIS IS NOT FREE SOFTWARE!  You may evaluate and use this product, but if you
  1634. decide to make use of it on a regular basis, you must register your copy.
  1635.  
  1636. Note:  Businesses, government agencies and institutions are required to
  1637. register this software package before extended use.
  1638.  
  1639. We offer several inducements to you for registering.  First of all, you will
  1640. receive the most up-to-date copy of the program that we have -- and we update
  1641. the program on a regular basis.  Also, we have quite a few additional mini-
  1642. utilities that work very nicely with DOSview not included in this package that
  1643. we will ship to you upon registration.  Third, you will never see the
  1644. shareware message again.  Make no mistake, however -- this is a fully
  1645. functional version of DOSview that is not "crippled" in any way (other than
  1646. the shareware notice when requesting help).
  1647.  
  1648.  
  1649. Distribution
  1650. ------------
  1651. This is "user-supported" software.  You are hereby granted permission to
  1652. distribute this evaluation copy of DOSview and its documentation, subject to
  1653. the following conditions:
  1654.  
  1655. 1.  DOSview may be distributed freely without charge in evaluation form only.
  1656.  
  1657. 2.  DOSview may not be sold, licensed, or a fee charged for its use.  If a fee
  1658.     is charged in connection with DOSview, it must cover the cost of copying
  1659.     or dissemination only.  Such charges must be clearly identified as such by
  1660.     the originating party.  Under no circumstances may the purchaser be given
  1661.     the impression that he is buying DOSview itself.
  1662.  
  1663. 3.  DOSview must be presented as a complete unit, including this
  1664.     documentation.  Neither DOSview nor its documentation may be amended or
  1665.     altered in any way without permission of the copyright holder.
  1666.  
  1667. 4.  By granting you the right to distribute the evaluation form of DOSview,
  1668.     you do not become the owner of DOSview in any form.
  1669.  
  1670. Any other use, distribution or representation of DOSview is expressly
  1671. forbidden without the written consent from the author.
  1672.  
  1673.  
  1674. Registration
  1675. ------------
  1676. The non-commercial single-user registration fee for DOSview is $40.00 US.  
  1677. ($5 shipping is included.)
  1678.  
  1679. The commercial/government and multi-system site fee for DOSview is $160.00 US.
  1680. ($10 shipping is included.)
  1681.  
  1682. Send a check, money order or company P.O. for the appropriate amount to:
  1683.  
  1684.           Skip Bremer - DOSview
  1685.           3401 Cactus Wren Way
  1686.           Austin, Texas 78746
  1687.  
  1688. Thank you.
  1689.  
  1690.  
  1691. Disclaimer
  1692. ----------
  1693. The author does not warrant that the functions contained in this program will
  1694. meet your requirements or that the program operation will be uninterrupted or
  1695. error free.
  1696.  
  1697. The author specifically disclaims all other warranties, expressed or implied,
  1698. including but not limited to implied warranties of fitness for any particular
  1699. purpose and of merchantability.
  1700.  
  1701. In no event will the author be liable to you for any damages, including but
  1702. not limited to any lost profits, lost savings, commercial damage or other
  1703. incidental or consequential damages arising out of the use or inability to use
  1704. this program, or for any claim by any other party.
  1705.